home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / Tcl-Tk 8.0 / Pre-installed version / MacTcl README < prev    next >
Encoding:
Text File  |  1997-08-15  |  6.3 KB  |  174 lines  |  [TEXT/ALFA]
  1. Tcl 8.0 for Macintosh
  2.  
  3. by Ray Johnson
  4. Sun Microsystems Laboratories
  5. rjohnson@eng.sun.com
  6.  
  7. SCCS: @(#) README 1.27 97/08/15 09:22:00
  8.  
  9. 1. Introduction
  10. ---------------
  11.  
  12. This is the README file for the Macintosh version of the Tcl
  13. scripting language.  The file consists of information specific
  14. to the Macintosh version of Tcl.  For more general information
  15. please read the README file in the main Tcl directory.
  16.  
  17. 2. What's new?
  18. --------------
  19.  
  20. The main new feature is the Tcl compilier.  You should certainly
  21. notice the speed improvements.  Any problems are probably
  22. generic rather than Mac specific.  If you have questions or
  23. comments about the compilier feel free to forward them to the
  24. author of the compilier: Brian Lewis <btlewis@eng.sun.com>.
  25. Several things were fixed/changed since the a1 release so be
  26. sure to check this out.
  27.  
  28. The largest incompatible change on the Mac is the removal of the
  29. following commands: "rm", "rmdir", "mkdir", "mv" and "cp".  These
  30. commands were never really supported and their functionality is
  31. superceded by the file command.
  32.  
  33. I've also added in a new "AppleScript" command.  This was contributed
  34. by Jim Ingham who is a new member of the Tcl group.  It's very cool.
  35. The command isn't actually in the core - you need to do a "package
  36. require Tclapplescript" to get access to it.  This code is official
  37. unsupported and will change in the next release.  However, the core
  38. functionality is there and is stable enough to use.  Documentation 
  39. can be found in "AppleScript.html" in the mac subdirectory.
  40.  
  41. The resource command has also been rewacked.  You can now read and
  42. write any Mac resource.  Tcl now has the new (and VERY COOL) binary
  43. command that will allow you to pack and unpack the resources into
  44. useful Tcl code. We will eventually provide Tcl libraries for
  45. accessing the most command resources.
  46.  
  47. See the main Tcl README for other features new to Tcl 8.0.
  48.  
  49. 3. Mac specific features
  50. ------------------------
  51.  
  52. There are several features or enhancements in Tcl that are unique to 
  53. the Macintosh version of Tcl.  Here is a list of those features and
  54. pointers to where you can find more information about the feature.
  55.  
  56. * The "resource" command allows you manipulate Macintosh resources.
  57.   A complete man page is available for this command.
  58.  
  59. * The Mac version of the "source" command has an option to source from
  60.   a Macintosh resource.  Check the man page from the source command
  61.   for details.
  62.  
  63. * The only command NOT available on the Mac is the exec command.
  64.   However, we include a Mac only package called Tclapplescript that
  65.   provides access to Mac's AppleScript system.  This command is still
  66.   under design & construction.  Documentatin can be found in the mac
  67.   subdirectory in a file called "AppleScript.html".
  68.  
  69. * The env variable on the Macintosh works rather different than on
  70.   Windows or UNIX platforms.  Check out the tclvars man page for
  71.   details.
  72.  
  73. * The command "file volumes" returns the available volumes on your
  74.   Macintosh.  Check out the file command for details.
  75.  
  76. * The command "file attributes" has the Mac specific options of
  77.   -creator and -type which allow you to query and set the Macintosh
  78.   creator and type codes for Mac files.  See file man page for details.
  79.  
  80. If you are writing cross platform code but would still like to use
  81. some of these Mac specific commands, please remember to use the
  82. tcl_platform variable to special case your code.
  83.  
  84. 4. The Distribution
  85. -------------------
  86.  
  87. Macintosh Tcl is distributed in three different forms.  This 
  88. should make it easier to only download what you need.  The 
  89. packages are as follows:
  90.  
  91. mactk8.0.sea.hqx
  92.  
  93.     This distribution is a "binary" only release.  It contains an
  94.     installer program that will install a 68k, PowerPC, or Fat
  95.     version of the "Tcl Shell" and "Wish" applications.  In addition,
  96.     it installs the Tcl & Tk libraries in the Extensions folder inside
  97.     your System Folder.
  98.  
  99. mactcltk-full-8.0.sea.hqx
  100.  
  101.     This release contains the full release of Tcl and Tk for the
  102.     Macintosh plus the More Files packages which Macintosh Tcl and Tk
  103.     rely on.
  104.  
  105. mactcl-source-8.0.sea.hqx
  106.  
  107.     This release contains the complete source for Tcl 8.0.  In
  108.     addition, Metrowerks CodeWarrior libraries and project files
  109.     are included.  However, you must already have the More Files
  110.     package to compile this code.
  111.  
  112. 5. Documentation
  113. ----------------
  114.  
  115. The "html" subdirectory contains reference documentation in
  116. in the HTML format.  You may also find these pages at:
  117.  
  118.     http://sunscript.sun.com/man/tcl8.0/contents.html
  119.  
  120. Other documentation and sample Tcl scripts can be found at
  121. the Tcl ftp site: 
  122.  
  123.     ftp://ftp.neosoft.com/tcl/
  124.  
  125. The internet news group comp.lang.tcl is also a valuable
  126. source of information about Tcl.  A mailing list is also
  127. available (see below).
  128.  
  129. 6. Compiling Tcl
  130. ----------------
  131.  
  132. In order to compile Macintosh Tcl you must have the 
  133. following items:
  134.  
  135.     CodeWarrior Pro 1
  136.     Mac Tcl 8.0 (source)
  137.     More Files 1.4.3
  138.  
  139. There are two sets of project files included with the package. The ones
  140. we use for the release are for CodeWarrior Pro 1, and are not compatible
  141. with CodeWarrior Gold release 11 and earlier. We have included the files
  142. for earlier versions of CodeWarrior, but we won't be supporting them after
  143. the 8.0 final release.
  144.  
  145. The project  files included with the Mac Tcl source should work 
  146. fine.  The only thing you may need to update are the access paths.
  147. Unfortunantly, it's somewhat common for the project files to become
  148. slightly corrupted.  The most common problem is that the "Prefix file"
  149. found in the "C/C++ Preference" panel is incorrect.  This should be
  150. set to MW_TclHeaderPPC, MW_TclHeader68K or MW_TclHeaderCFM68K.
  151.  
  152. To build the fat version of TclShell, open the project file "TclShells.π",
  153. select the "TclShell" target, and build. All of the associated binaries will
  154. be built automoatically. There are also targets for building static 68K
  155. and Power PC builds, for building a CFM 68K build, and for building a
  156. shared library Power PC only build.
  157.  
  158. Special notes:
  159.  
  160. * There is a small bug in More Files 1.4.3.  Also you should not use
  161.   MoreFiles 1.4.4 - 1.4.6.  Look in the file named morefiles.doc for
  162.   more details.
  163.  
  164. * You may not have the libmoto library which will cause a compile 
  165.   error.  You don't REALLY need it - it can be removed.  Look at the
  166.   file libmoto.doc for more details.
  167.  
  168. * Check out the file bugs.doc for information about known bugs.
  169.  
  170. If you have comments or Bug reports send them to:
  171. Jim Ingham
  172. jingham@eng.sun.com
  173.  
  174.